home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / jet114.zip / JETMAIL.DOC < prev    next >
Text File  |  1992-02-25  |  93KB  |  2,047 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.            ╔═══════════════════════════════════════════════╗
  8.            ║     ██ █████ ██████ ███  ███ ██████ ██ ██     ║
  9.            ║     ██ ██▄▄    ██   ██ ██ ██ ██  ██ ██ ██     ║
  10.            ║     ██ ██▀▀    ██   ██    ██ ██████ ██ ██     ║
  11.            ║ ██████ █████   ██   ██    ██ ██  ██ ██ ██████ ║
  12.            ║  .QWK-Compatible Mail Door for Spitfire 3.x   ║
  13.            ╚═══════════════════════════════════════════════╝
  14.  
  15.                JetMail version 1.10               JetMail version 1.10
  16.                Copyright (c) 1991,92 by DJ Chuang
  17.                All Rights Reserved
  18.  
  19.  
  20.  
  21.                        JETMAIL DOCUMENTATION TABLE OF CONTENTS
  22.  
  23.           COPYRIGHT & DISCLAIMER  . . . . . . . . . . . . . . . . . . .   2
  24.  
  25.           INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . .   2
  26.  
  27.           HOW DOES JETMAIL & 'QWK' WORK?  . . . . . . . . . . . . . . .   3
  28.  
  29.           SYNTAX  . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  30.  
  31.           INSTALLATION  . . . . . . . . . . . . . . . . . . . . . . . .   5
  32.                File transfers . . . . . . . . . . . . . . . . . . . . .  11
  33.  
  34.           JETMAIL SYSTEM FILES  . . . . . . . . . . . . . . . . . . . .  17
  35.  
  36.           USING JETMAIL . . . . . . . . . . . . . . . . . . . . . . . .  17
  37.  
  38.           WHILE ONLINE  . . . . . . . . . . . . . . . . . . . . . . . .  19
  39.  
  40.           JETMAIL AUTO-PILOT  . . . . . . . . . . . . . . . . . . . . .  19
  41.  
  42.           LOCAL JETMAIL USE . . . . . . . . . . . . . . . . . . . . . .  20
  43.  
  44.           COMMAND-LINE USE OF JETMAIL . . . . . . . . . . . . . . . . .  21
  45.  
  46.           MULTI-NODE USE OF JETMAIL . . . . . . . . . . . . . . . . . .  21
  47.  
  48.           JETMAIL SYSTEM MANAGER  . . . . . . . . . . . . . . . . . . .  22
  49.  
  50.           JETMAIL AS A NETWORK HUB  . . . . . . . . . . . . . . . . . .  24
  51.  
  52.           REGISTRATION & SUPPORT  . . . . . . . . . . . . . . . . . . .  25
  53.  
  54.           AUTHOR NOTES & THANKS . . . . . . . . . . . . . . . . . . . .  27
  55.  
  56.           ACKNOWLEDGEMENTS  . . . . . . . . . . . . . . . . . . . . . .  28
  57.  
  58.           QUESTIONS AND ANSWERS . . . . . . . . . . . . . . . . . . . .  29
  59.  
  60.           JETMAIL DOCUMENTATION INDEX . . . . . . . . . . . . . . . . .  31
  61.  
  62.  
  63.  
  64.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.           COPYRIGHT & DISCLAIMER          COPYRIGHT & DISCLAIMER
  72.           ----------------------
  73.  
  74.           DJ Chuang shall not be liable to any users of JetMail for any
  75.           damages, including any lost profits, lost savings or other
  76.           incidental or consequential damages arising out of the use or
  77.           inability to use the program, or for any claim by any other
  78.           party. Total responsibility for use herein lies with the user.
  79.  
  80.           This JetMail software is being distributed as "shareware". You
  81.           may freely distribute this program to other sysops, and you are
  82.           encouraged to do so. You may try out JetMail for a trial period
  83.           of 30 (thirty) days. If you continue to use JetMail, fill out the
  84.           REGISTER.JET registration form and mail appropriate payment to
  85.           the author of this software. Registration will remove the extra
  86.           tagline that is attached at the end of each message posted via
  87.           JetMail.
  88.  
  89.           JetMail may not be distributed by software vendors without
  90.           expressed written consent of author.
  91.  
  92.  
  93.           INTRODUCTION          INTRODUCTION
  94.           ------------
  95.  
  96.           JetMail is a DOOR (external program) designed for use with
  97.           SPITFIRE 3.x BBS software, (c) 1990 by Mike Woltz (Buffalo Creek
  98.           Software). JetMail is a .QWK-compatible offline mail door, which
  99.           allows users to conveniently and efficiently read messages and
  100.           reply to messages offline. JetMail uses the .QWK format for mail
  101.           packet transfers. The .QWK format is a popular offline mail
  102.           format introduced by Mark Herring, author of QMail door for
  103.           PCBoard systems. Using this format, the user is able to use an
  104.           offline mail reader of his or her choice. There are many
  105.           different .QWK-format mail readers, each with certain unique
  106.           features to meet the needs of different users. Some offline .QWK
  107.           mail readers include:  SLMR, QMail DeLuxe, EZ-Reader, Session
  108.           Manager, Jabber, Speed Read, KingQWK, Power-QWK, RoseReader,
  109.           WinQWK, WinRead, AmigaReader, and MegaMail Reader 2.10. NOTE: 
  110.           MegaMail Reader must be version 2.10 release, not a beta version!
  111.  
  112.           The use of offline mail doors will make it considerably easier
  113.           for users to participate in conferences, allow more users to
  114.           login to your BBS on a daily basis (because they won't tie up the
  115.           board reading messages), make message posting more efficient and
  116.           fun (taglines are a popular and humorous diversion), and assist
  117.           the sysop to keep up with message flow as well.
  118.  
  119.           This documentation is written using WordPerfect 5.1. The .DOC
  120.           file that is distributed with JetMail ZIP is a standard DOS text
  121.           file ready for printing. You may view this document using Vern
  122.           Buerg's LIST or something comparable, but some paragraph headings
  123.           will appear "twice", which means when this document is printed,
  124.           the printer will make those "double lines" bold print.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.           HOW DOES JETMAIL & 'QWK' WORK?          HOW DOES JETMAIL & 'QWK' WORK?
  139.           ------------------------------
  140.  
  141.           I will now try to explain how an offline mail system works in the
  142.           JetMail .QWK environment. When you setup JetMail, you will assign
  143.           your BBS an ID code (up to 8 letters). We'll use SPITFIRE as your
  144.           ID code for this illustration. A user logs in to your BBS and
  145.           desires to read messages with her .QWK-format offline reader. She
  146.           finds out that you have JetMail and is elated!  She selects the
  147.           JetMail door from Spitfire, then once she is in JetMail, she uses
  148.           the JetMail Configuration command to select a transfer protocol
  149.           and other parameters for her reader. Then she uses the Select
  150.           Conferences command in JetMail to select conferences she wishes
  151.           to scan for messages. 
  152.  
  153.           Then she selects the Download command from JetMail, which will
  154.           scan all her selected conferences for new messages. JetMail will
  155.           prepare a mail packet, which will be named SPITFIRE.QWK,
  156.           containing all the messages she has not read. (This packet
  157.           contains the messages and special pointers iaw [in accordance
  158.           with] the .QWK format.)  She logs off the BBS. Some other users
  159.           can now call your BBS while she reads messages from your BBS
  160.           using her offline mail reader. 
  161.  
  162.           She will use her favorite offline mail reader and proceed to read
  163.           all the new messages from your BBS. She replies to a couple of
  164.           messages, in the end resulting a file named SPITFIRE.REP on her
  165.           computer. She calls your BBS, opens JetMail door, and selects the
  166.           Upload command. She uploads her SPITFIRE.REP, JetMail receives it
  167.           and processes the reply packet, posting her reply messages in the
  168.           corresponding conferences. 
  169.  
  170.           That's a thumbnail sketch of JetMail in action. It's not much fun
  171.           reading about how all of this works--the fun comes when you get
  172.           to use JetMail and your preferred offline mail reader. Try out
  173.           JetMail, and tinker with the switches that are available, and
  174.           you'll quickly learn how everything works together. 
  175.  
  176.           Many offline mail reader programs are shareware, so be sure you
  177.           try out a couple of different ones to find one with which you are
  178.           most comfortable. Don't settle for second best. Then again, you
  179.           might have difficulty locating several different readers, or have
  180.           trouble switching between different readers because they're all
  181.           so different, or just don't have the time to experiment. In that
  182.           case, you can stick with the first QWK reader you find, and that
  183.           is okay too.
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 3
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.           SYNTAX          SYNTAX
  205.           ------
  206.  
  207.           Syntax:  JETMAIL door_sys_file [cnf_file] [EVENT]
  208.                    where door_sys_file is path and filename for                         door_sys_file 
  209.                                        Spitfire's DOOR.SYS
  210.                          [cnf_file]   is an optional parameter, which                          cnf_file
  211.                                       specifies a JetMail configuration
  212.                                       file. This must be specified for
  213.                                       using JetMail in a multi-node
  214.                                       environment. The configuration file
  215.                                       must have an extension of .CNF .
  216.                          EVENT        Specify this as the last parameter if                         EVENT
  217.                                       you'd like to run JetMail in its
  218.                                       Auto-pilot mode, which will allow
  219.                                       JetMail to run unattended during a
  220.                                       system event so you as the sysop can
  221.                                       scan for new mail.
  222.  
  223.           Examples:  
  224.           JETMAIL \SF\DOOR.SYS
  225.                Open JetMail door using COM port specified in DOOR.SYS, and
  226.                JetMail configuration file named JETMAIL.CNF, which is the
  227.                default filename when no configuration file is specified.
  228.  
  229.           JETMAIL \SF\DOOR.SYS JETMAIL.CNF
  230.                Open JetMail door using COM port specified in DOOR.SYS, and
  231.                use JetMail configuration JETMAIL.CNF. This also enables
  232.                JetMail to run its SHARE-compatible code for multi-node
  233.                environment. (NOTE: When a .CNF file is explicitly specified                             NOTE
  234.                in the JetMail command line, JetMail will activate its
  235.                SHARE- compatible code; if not specified, JetMail will not
  236.                be SHARE compatible. In other words, if you're only running
  237.                a single node, use the default JETMAIL.CNF filename for your
  238.                JetMail configuration, and do not specify the .CNF parameter
  239.                in the command line - use: JETMAIL \SF\DOOR.SYS)
  240.  
  241.           JETMAIL \SF\DOOR.SYS JETNODE1.CNF
  242.                Open JetMail door using COM port specified in DOOR.SYS, and
  243.                use JetMail configuration file named JETNODE1.CNF. The
  244.                configuration file contains parameters specifying how
  245.                JetMail operates. The contents of the configuration file are
  246.                enumerated in the JetMail installation section. 
  247.  
  248.           JETMAIL \JET\DOOR.SYS EVENT
  249.                Run JetMail in Auto-pilot mode, which is unattended. JetMail
  250.                will scan for new mail, and place the new .QWK in the
  251.                directory specified by the LOCALDIR= parameter in the .CNF
  252.                configuration. JetMail will also look for an .REP packet in
  253.                the LOCALDIR directory and post any new replies. You need to
  254.                manually (or in your system event batch file) delete the
  255.                .REP packet after it is processed.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 4
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.           INSTALLATION          INSTALLATION
  271.           ------------
  272.  
  273.           Introduction:  Spitfire 3.x generates a DOOR.SYS upon opening a
  274.           door (external program). JetMail uses this file to locate
  275.           Spitfire files, user's name and time remaining, and basic
  276.           communication parameters. JetMail will automatically use Spitfire
  277.           system files for other system information. JetMail is designed to
  278.           work with as much Spitfire dependence as possible so that when
  279.           you make changes to the Spitfire system files, the changes will
  280.           automatically be used by JetMail so you don't have to run a
  281.           special JetMail companion utility program (which you might
  282.           legitimately forget to do if you're running a larger BBS system
  283.           with many doors or other setups). The only exception to this is
  284.           if you use a special short conference names list in CONFLIST.JET
  285.           (more details on this later).
  286.  
  287.           1.   Decide how you want to install JetMail. There are three
  288.                basic options:
  289.  
  290.            a. As a DOOR in the Doors Menu.
  291.            b. As an external command from the Main Menu.
  292.            c. As an external command from the Message Section.
  293.  
  294.                What is the difference, you might ask?  Options B and C will
  295.                let the user to invoke JetMail considerably quicker by just
  296.                using the one key command from one of the main menus.
  297.                However, Spitfire will stay in memory, leaving less memory
  298.                available for JetMail. JetMail may be able to run in the
  299.                memory remaining just fine, but JetMail may run into memory
  300.                problems, depending on your computer configuration. It will
  301.                not display any messages (like "Loading JetMail, Please
  302.                Wait..") when the user selects JetMail from a main menu, and
  303.                it also eliminates the need of the user to re-enter his
  304.                password when returning to Spitfire (this may or may not be
  305.                desired; JetMail does have carrier detect checking, and will
  306.                properly return to Spitfire should a user logoff
  307.                abnormally.)
  308.  
  309.                Option A, setting up JetMail as a door from the Doors menu,
  310.                will allow Spitfire to be totally removed from memory during
  311.                JetMail operation. It makes available all possible memory
  312.                for JetMail use. JetMail itself doesn't use a lot of memory,
  313.                but it does shell out to compression utilities to build QWK
  314.                packets and to make file transfers, so depending on what
  315.                utilities you use in conjunction with JetMail, this will
  316.                affect the total memory usage. Running JetMail as a door
  317.                will alleviate your task of trying to figure out if there is
  318.                enough memory to run JetMail and the compression utilities
  319.                together. Option A will display a please-wait message when
  320.                the door is being executed, and it will ask the user to re-
  321.                enter password when control is returned to Spitfire.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 5
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.                If you can't decide which setup option to use, and you want
  337.                to play it safe, the best option to select is A. However, if
  338.                you're comfortable and knowledgeable with DOS and Spitfire
  339.                environment as a sysop, you can install two or more of the
  340.                above options just as easily. Making JetMail available from
  341.                several places may serve as an added convenience for your
  342.                users, and it doesn't take up much extra space at all (just
  343.                an extra menu item, so all in all maybe 80 bytes).
  344.  
  345.  
  346.           2.   Place all JetMail files in a separate subdirectory (e.g.
  347.                D:\JETMAIL). We will call this directory the "home
  348.                directory" for JetMail. These files are must be placed in
  349.                the home directory for proper operation:
  350.  
  351.                JETMAIL.EXE
  352.                JETMAIL.CNF    (or multiple .CNF files for multi-node use)
  353.                JETTEXT.DAT    * do not modify this *
  354.                JETMAIL.ID     * do not modify this *
  355.                JETMENU.BBS
  356.                JETMENU.CLR
  357.                JETHELP.MAI
  358.                JETHELP.USR
  359.                JETHELP.SEL
  360.                NEWUSER
  361.  
  362.  
  363.           3.   Edit the JETMAIL.CNF to contain system information needed
  364.                for JetMail operation. JETMAIL.CNF is a simple ASCII text
  365.                file; you may use a good editor to modify the sample .CNF
  366.                file that comes with this ZIP. Syntax for each line is the
  367.                parameter name and the equal sign "=" (no space between
  368.                parameter name and equal sign). One parameter per line.
  369.  
  370.           The JETMAIL.CNF file must contain the first five parameters
  371.           listed here, and it may also contain a number of other optional
  372.           parameters:
  373.  
  374.           BBSNAME=  This is the name of your BBS. You can use up to 70
  375.                     characters. 
  376.                     Ex.: BBSNAME=Your Decorative Name BBS
  377.  
  378.           BBSCITY=  This is the city and state where your BBS is located.
  379.                     It doesn't matter if you spell out the state name or
  380.                     use a standard 2 letter abbreviation. You can include a
  381.                     country name too.
  382.                     Ex.: BBSCITY=Anytown, California
  383.  
  384.           BBSPHONE= This is the phone number for your BBS. Just list one
  385.                     phone number if you have more than one node. If you do
  386.                     have more than one node, it would probably be most
  387.                     excellent to use that node's phone number in the
  388.                     corresponding .CNF file. 
  389.                     Ex.: BBSPHONE=(714)785-9176
  390.  
  391.  
  392.  
  393.  
  394.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 6
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.           SYSOPNOM= This is your name as the sysop (system operator).
  403.                     Please do use both first and last name.
  404.                     Ex.: SYSOPNOM=Joe Sysop
  405.  
  406.           BBSID=    ID code of BBS (up to 8 capital letters) this will be
  407.                     used to name the mail packet, SPITFIRE.QWK and
  408.                     SPITFIRE.REP in this example. You can use an acronym
  409.                     based on your BBS name, or some related abbreviation.
  410.                     NOTE: If you are also running MegaMail door on your
  411.                     BBS, you may need to use a BBS ID for JetMail that is
  412.                     different from the BBS ID of the MegaMail door, which
  413.                     is needed to distinguish between MegaMail Reader 2.10's
  414.                     QWK/REP or UL/DL modes.
  415.                     Ex.: BBSID=SPITFIRE
  416.  
  417.           THE ABOVE FIVE PARAMETERS MUST BE DEFINED IN THE .CNF FILE. 
  418.           The following parameters are optional.
  419.  
  420.           SPEED=    This parameter is needed by JetMail, depending on how
  421.                     you have Spitfire setup to communicate with the modem.
  422.                     By DEFAULT, JetMail will use SPEED=ACTUAL, which passes
  423.                     the user's actual connect speed as %B% to the JetMail
  424.                     file transfer command line (specified in JETXFER.DAT)
  425.                     during JetMail file transfers. In the ALT+M Modem
  426.                     configuration for Spitfire option <H> is for hardware
  427.                     data flow control. If this is set to YES, you will want
  428.                     to use SPEED=DTE. If this is set to NO, you will want
  429.                     to use SPEED=ACTUAL. 
  430.  
  431.                     Allowable values:
  432.                          DTE    -- Use the 'locked' port speed connection.
  433.                          ACTUAL -- Use caller's actual baud rate connection
  434.                                    speed.
  435.  
  436.           WELCOME=  Specify path and filename to welcome screen. Path is
  437.                     needed, and .BBS extension is changed to .CLR if user
  438.                     is in ANSI graphics mode, automatically. If .CLR file
  439.                     doesn't exist while user is in color graphic mode,
  440.                     JetMail will revert to the .BBS file.
  441.                     Ex.: WELCOME=D:\SF\DISPLAY\WELCOME.BBS
  442.  
  443.           NEWS=     Specify path and filename to latest system news. This
  444.                     could be your newsletter, if you use the newsletter
  445.                     feature to tell your users the latest happening, or it
  446.                     could be one of the other opening files. Only the .BBS
  447.                     version is packed in the .QWK.
  448.                     Ex.: NEWS=D:\SF\DISPLAY\SFNWSLTR.BBS
  449.  
  450.           GOODBYE=  Specify path and filename to goodbye/logoff screen. The
  451.                     .BBS extension is changed to .CLR if user is in ANSI
  452.                     graphics mode, automatically.
  453.                     Ex.: GOODBYE=D:\SF\DISPLAY\GOODBYE.BBS
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 7
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.           ADDNEWS=  This is a flag indicating whether to include the 'news'
  469.                     file (specified by the NEWS= parameter) is put in every
  470.                     .QWK packet, or just when the 'news' file has been
  471.                     changed since the last QWK transfer. The default value,
  472.                     when unspecified, is NEW.
  473.  
  474.                     Allowable values:
  475.                          ALWAYS  -- always include 'news' file in .QWK
  476.                          NEW     -- include 'news' file only when updated.
  477.  
  478.                     Ex.: ADDNEWS=NEW 
  479.  
  480.           WORKDIR=  Specify drive and path to work directory. JetMail will
  481.                     run faster if you can specify a directory on a RAM
  482.                     drive, provided there is sufficient room on the RAM
  483.                     drive to build a .QWK packet. If the work directory
  484.                     doesn't exist, JetMail will make the directory when
  485.                     JetMail is started. This work directory MUST NOT BE
  486.                     SHARED with any other program, and definitely NOT
  487.                     another JetMail node (each node .CNF must have a
  488.                     different WORKDIR specified); This directory must be an
  489.                     empty directory with sufficient disk space to build
  490.                     .QWK packets (which could be up to 1 megabyte in size,
  491.                     or even more). If this parameter is not specified,
  492.                     JetMail will make its own temporary work directory in
  493.                     the JetMail home directory.
  494.                     Ex.: WORKDIR=F:\TMP\
  495.  
  496.           LOCALDIR= Specify a default drive and path for placing mail
  497.                     packets (both .QWK and .REP's). When you use JetMail in
  498.                     Auto-Pilot mode (explained later), JetMail will place
  499.                     .QWK's in this directory. When using JetMail locally,
  500.                     either through Spitfire local login, or via command
  501.                     line, JetMail will not transfer the file remotely, and
  502.                     prompt you for a directory to put .QWK's. This
  503.                     parameter specifies the default directory during local
  504.                     use, or you can always manually type in a different
  505.                     directory. If this parameter is not specified, JetMail
  506.                     defaults to C:\ .
  507.                     Ex.: LOCALDIR=C:\QWK\
  508.  
  509.           FORCED=   A list of conference that must be included for all
  510.                     users' message scan. The user has the option of
  511.                     scanning for all new messages, or the "YA" scan (which
  512.                     scans new messages addressed to the user and to "All
  513.                     Users"). The list comprises of conference numbers,
  514.                     separated by commas. Example forces conferences
  515.                     numbered 1, 3, and 5.
  516.                     Ex.: FORCED=1,3,5
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 8
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.           DEFAULT=  Specify a list of conferences as default configuration;
  535.                     so the user doesn't start with a blank conference
  536.                     queue. These may be conferences that you recommend
  537.                     users to scan for messages, but don't want to force it
  538.                     on the users. Forced conferences (specified in FORCED=)
  539.                     will automatically be placed in the users' "default"
  540.                     queue (you don't need to specify forced conferences in
  541.                     this recommended queue list).
  542.                     Ex.: DEFAULT=2,4
  543.  
  544.           LOG=      This allows you to record user activities in JetMail to
  545.                     a different log file. JetMail by default will log
  546.                     JetMail user activity to the Spitfire CALLERS.TMP, so
  547.                     you can view all activities in one log file. However,
  548.                     if you would like to have JetMail log activity into a
  549.                     different log file, specify the path and filename here.
  550.                     The path must already exist when using a separate
  551.                     JetMail usage log. Be sure to specify unique log file
  552.                     names for each node, if you're running JetMail in a
  553.                     multi-node environment.
  554.                     Ex.: LOG=D:\JETMAIL\NODE1.LOG
  555.  
  556.           DONTPOST= This is a parameter to determine how JetMail will
  557.                     respond in situations when a user tries to post
  558.                     messages in conferences to which he has no access,
  559.                     invalid conference numbers, or private messages in
  560.                     conferences where only public messages are allowed. By
  561.                     default (or DONTPOST=NO), JetMail will post 'invalid'
  562.                     messages in Conference 1. An invalid message is a
  563.                     message in an uploaded .REP packet which is flagged as
  564.                     a private message, but attempts to be posted in a SF
  565.                     Public_Only Conference; OR, it is a message posted to
  566.                     an invalid conference number (trying to post a message
  567.                     in conference 20 when there are only 12 conferences).
  568.                     In both instances, JetMail will post the suspect
  569.                     message in Conference 1. If this parameter is set to
  570.                     YES, then in both instances, any 'invalid' messages
  571.                     will be skipped and NOT posted anywhere (in other
  572.                     words, discarded). There are no parameter settings
  573.                     which will cause JetMail to allow private message posts
  574.                     in a Public_Only conference (a SF conference that only
  575.                     allows public messages).
  576.                     Ex.: DONTPOST=NO
  577.  
  578.           NOBYE=    Set this to YES to disable the Goodbye command from
  579.                     JetMail, so that users cannot logoff from JetMail and
  580.                     will need to return to Spitfire to logoff. By default,
  581.                     NOBYE=NO, which allows users to logoff from JetMail.
  582.                     You will need to manually edit the JetMail menu text if
  583.                     you set NOBYE=YES. If a user tries to enter 'G' when
  584.                     NOBYE=YES, then the user will be returned to Spitfire.
  585.                     Ex.: NOBYE=YES
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 9
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.           SWAP=     JetMail is now able to swap out of memory when JetMail
  601.                     is packing a .QWK packet, unpacking an .REP packet, or
  602.                     when doing file transfer. This parameter needs to be
  603.                     specified, with a directory path to where JetMail will
  604.                     place its memory swap file. DO NOT USE the JetMail work
  605.                     directory (WORKDIR)!
  606.  
  607.                     If this parameter is NOT specified, JetMail will remain
  608.                     in memory when calling compression utilities and
  609.                     transfer programs. This may result 'transfer error' or
  610.                     'unable to compress packet', especially if JetMail is
  611.                     run as a message menu extension, in which case JetMail
  612.                     remains in memory as well as Spitfire, which doesn't
  613.                     leave much memory left to shell out to do anything
  614.                     else. Another option that is available if you don't
  615.                     want to use the SWAP= parameter in JetMail is to use an
  616.                     utility called SHROOM, which can swap Spitfire to disk
  617.                     prior to running JetMail.
  618.  
  619.                     When this parameter specifies a valid path, JetMail
  620.                     will first try to swap to EMS memory, and then swap to
  621.                     the specified swap path if there is not enough EMS
  622.                     memory (or if there isn't EMS memory to swap to). Now
  623.                     JetMail should be able to run in considerably smaller
  624.                     memory situations, such as a Spitfire message menu
  625.                     extension.
  626.                     Ex.: SWAP=F:\SWAP
  627.  
  628.           AFTER=    This parameter may be used to specify a command line
  629.                     for JetMail to run after it receives an .REP packet.
  630.                     This may be used to run a duplicate-message checker
  631.                     such as KILLQDUP. Be sure to specify the .EXE extension
  632.                     if running an .EXE file; this command line cannot run
  633.                     batch files.
  634.                     Ex.: AFTER=KILLQ.EXE F:\TMP\SPITFIRE.MSG 
  635.  
  636.           PRIORITY= This is a switch that some sysops requested for
  637.                     JetMail. Usually, if you specify a conference's access
  638.                     to be exclusively level 10 users (security level equal
  639.                     to 10 only), then even sysops cannot access that
  640.                     conference. However, some sysops feel that they as
  641.                     sysops should have access to 'exclusive' conferences.
  642.                     An example might be that you have user levels 10, 20,
  643.                     and 30, and sysop level at 100. You want to setup
  644.                     conference 5 for level 20 users only, and exclude 10's
  645.                     and 30's, but not sysop(s). (If you setup the
  646.                     conference access to be security level "equal to or
  647.                     greater than", then both 20's and 30's gets access to
  648.                     the conference, which is undesired). Set PRIORITY=YES
  649.                     to allow sysops to access 'exclusive' conferences
  650.                     through JetMail. Default is PRIORITY=NO.
  651.                     Ex.: PRIORITY=YES
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 10
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.                If no compression utilities are explicitly specified in the
  667.                JetMail configuration file, JetMail will automatically use
  668.                PKZIP/PKUNZIP to process QWK and REP packets. The following
  669.                parameters are available if you use a non-standard PKZIP.EXE
  670.                filename, or want to use some fancy parameters. JetMail can
  671.                support up to 3 (three) compression utilities, so up to 3
  672.                (three) sets of PACK parameters may be specified. These
  673.                utilities MUST be in the DOS path, or you could explicitly
  674.                specify the path to the compression utility here.
  675.  
  676.           PACK1=    Specify the commonly used extension name for the first
  677.                     compression utility. It may be possible to use more
  678.                     than three letters, but that is an untested feature.
  679.                     Ex.: PACK1=ZIP
  680.  
  681.           PACK1QWK= Specify the command to compress files into a .QWK
  682.                     packet. Use the Add files command of your compression
  683.                     utility.
  684.                     Ex.: PACK1QWK=PKZIP -A
  685.                       or PACK1QWK=C:\UTIL\PKZIP.EXE -A
  686.  
  687.           PACK1REP= Specify the command to uncompress a REP packet. Use the
  688.                     extract command of your compression utility with the
  689.                     overwrite flag set (if possible) for best results.
  690.                     Ex.: PACK1REP=PKUNZIP -O
  691.  
  692.           PACK2=    Specify name for a second compression utility.
  693.                     Corresponding pack/unpack parameters: 
  694.                     PACK2QWK=
  695.                     PACK2REP=
  696.  
  697.           PACK3=    Specify name for a third compression utility.
  698.                     Corresponding pack/unpack parameters: 
  699.                     PACK3QWK=
  700.                     PACK3REP=
  701.  
  702.  
  703.           4.   File transfers in JetMail, uploading REP's and downloading
  704.                QWK's, is facilitated by the use of command lines specified
  705.                in JETXFER.DAT. This is new in JetMail version 1.10, to
  706.                replace the antiquated and often confusing transfer batch
  707.                files in prior JetMail versions.
  708.  
  709.                JETXFER.DAT is a simple text file, placed in your JetMail
  710.                home directory. The format for this .DAT file consists of
  711.                three lines for each transfer protocol:
  712.  
  713.                     <L> Name_of_Protocol
  714.                     Command_line_for_SEND_QWK_packet
  715.                     Command_line_for_RECEIVE_REP_packet
  716.  
  717.                You may add more protocols to JetMail by enter more three-
  718.                line entries for each protocol. Place the letter of the
  719.                protocol between the brackets < >, and follow the example
  720.                JETXFER.DAT included with the JetMail distribution .ZIP .
  721.                The letter used for the protocol can be any capital letter
  722.  
  723.  
  724.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 11
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.                from A to Z, or any number from 1 to 9. So this means that
  732.                you could install 35 transfer protocols in JetMail if
  733.                desired.
  734.  
  735.                The first item in the JETXFER.DAT file transfer command line
  736.                is the name of the .EXE or .COM transfer protocol engine
  737.                executable that needs to be run. Then follow it with
  738.                parameters that the transfer protocol needs.
  739.  
  740.                Any of four macro-parameters may be specified on the
  741.                JETXFER.DAT file transfer command line, as needed. These
  742.                macro-parameters will be substituted with the corresponding
  743.                values when JetMail calls the command line to make a file
  744.                transfer:
  745.                          %B%  baud rate
  746.                          %F%  filename to transfer
  747.                          %P%  port number
  748.                          %D%  directory path to JetMail work directory
  749.  
  750.                When JetMail is ready to transfer a file (either to send a
  751.                .QWK packet, or to receive an .REP packet), JetMail will
  752.                replace the above macros specified on the command line with
  753.                the corresponding information. After calling the transfer
  754.                protocol engine, JetMail will check the error level returned
  755.                by the transfer program, and act accordingly. JetMail
  756.                expects the transfer program to return with exit code 0 upon
  757.                successful transfer, and exit code 1 (or greater) upon
  758.                unsuccessful transfer (be it lost carrier or aborted
  759.                transfer).
  760.  
  761.                Here's a sample JETXFER.DAT file:
  762.  
  763.                <Z> Zmodem (MobyTurbo)
  764.                DSZ.COM port %P% sz %F%
  765.                DSZ.COM port %P% rz %F%
  766.                <1> Xmodem-1K
  767.                dsz.com port %P% sx -k %F%
  768.                dsz.com port %P% rc %F%
  769.                <G> Ymodem-G (MNP only)
  770.                dsz.com port %P% sb -g %F%
  771.                dsz.com port %P% rb -g %F%
  772.                <C> Xmodem/CRC
  773.                dsz.com port %P% sx %F%
  774.                dsz.com port %P% rc %F%
  775.                <H> HS/Link (bi-directional)
  776.                HSLINK.EXE -E%B% -p%P% -A -u%D% -R -K %F%
  777.                HSLINK.EXE -E%B% -p%P% -A -u%D% -R -K
  778.  
  779.                Suppose a 2400 baud caller is connected to your BBS, and
  780.                selects the HS/Link protocol in his JetMail user
  781.                configuration. After he scans for new mail (using the "D"
  782.                download command), and JetMail is ready to transfer the .QWK
  783.                packet to the user, JetMail will call up the following
  784.                command line (notice the macros values being appropriately
  785.                replaced):
  786.  
  787.  
  788.  
  789.  
  790.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 12
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.                HSLINK.EXE -E2400 -p1 -A -uF:\TMP\ -R -K F:\TMP\SPITFIRE.QWK
  799.  
  800.                (comment: macros were replaced with corresponding .CNF
  801.                values of WORKDIR=F:\TMP, BBSID=SPITFIRE, SPEED=ACTUAL, and
  802.                COM1)
  803.  
  804.                THIS IS VERY IMPORTANT! When adding new transfer protocols
  805.                to JetMail, be sure to specify the .COM or .EXE extension
  806.                for the transfer program, and make sure that transfer
  807.                program is in the DOS path (or specify the entire path to
  808.                the transfer program in the command line, for example,
  809.                C:\COMM\DSZ.COM . . . ) Also be sure to specify the
  810.                protocol's letter, description, and 2 separate command lines
  811.                specifying both send and receive commands.
  812.  
  813.  
  814.           5.   Tell Spitfire you have the door installed. This will differ
  815.                based on the option you've selected. More than one option is
  816.                allowed (if you want to make available JetMail at every menu
  817.                possible, to encourage its use, that is your choice) 
  818.  
  819.  
  820.           ***** Option A: (door menu) *****
  821.  
  822.           A1.  Edit SFDOOR.MNU in your main SF directory. Insert a line
  823.                with the name of the door being "JetMail" (no quotes), and a
  824.                minimum security level you will allow users to access
  825.                JetMail. Remember that the SFDOOR.MNU uses the line number
  826.                of the text to indicate the letter of the door, so for this
  827.                example we'll say that JetMail will go on line 2 (door "B").
  828.                So the text line should look something like:
  829.  
  830.                     JetMail,10
  831.  
  832.                You may want to be a little more elaborate on the door's
  833.                name for this menu to let your user know that JetMail is
  834.                QWK-Compatible. Announcing the arrival of JetMail in your
  835.                newsletter would also be a good way to let your users know
  836.                of this new door. Refer to the section entitled "SPITFIRE
  837.                DOORS" in the Spitfire documentation if you need more
  838.                details.
  839.  
  840.           A2.  Edit your SF.BAT to contain something like:
  841.  
  842.                :door_b
  843.                   rem Place Door B Commands Here
  844.                   D:
  845.                   CD \JETMAIL
  846.                   JETMAIL D:\SF\DOOR.SYS
  847.                   goto loop
  848.  
  849.                I've left the surrounding SF.BAT lines (in lowercase) in to
  850.                show you how the insertion would look. Be sure you give the
  851.                correct path name to the DOOR.SYS file, which will be
  852.                located in your main SF directory. (watch out for drive
  853.                letters if you're running multiple drive partitions!)
  854.  
  855.  
  856.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 13
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.           A3. That should be it for Option A. Try a local login, and watch
  864.               JetMail appear in your door menu.
  865.  
  866.  
  867.           ***** Option B: (main menu command) *****
  868.  
  869.           B1.  Edit SFMAIN.MNU in your main SF directory. Modify the line
  870.                with the Command Identifier "@" (the last parameter on each
  871.                line). Change the Command Character (the first parameter)
  872.                line to the letter "J" (for JetMail), modify the command
  873.                description, set a minimum security level you will allow
  874.                users to access JetMail, and leave the "@" sign. So the text
  875.                line should look something like:
  876.  
  877.                     J,<J>..... JetMail Offline Mail,,10,@
  878.  
  879.                [An unaltered menu usually has the "@" Command Identifier
  880.                attached to the "K" Command Character.]  Remember that the
  881.                SFMAIN.MNU only allows one "@" Command Identifier to be a
  882.                sysop-configured command. Don't confuse the Command
  883.                Character and Command Identifier.
  884.  
  885.           B2. Edit SFMAIN.BAT (in your main Spitfire directory) to: 
  886.  
  887.                D:
  888.                CD \JETMAIL
  889.                JETMAIL D:\SF\DOOR.SYS
  890.  
  891.                Be sure you give the correct path name to the DOOR.SYS file,
  892.                which will be located in your main SF directory. (watch out
  893.                for drive letters if you're running multiple drive
  894.                partitions!)
  895.  
  896.           B3.  That should be it for Option B. Try a local login, and watch
  897.                JetMail appear in your main menu. If you are using
  898.                SFMAIN.BBS and SFMAIN.CLR, don't forget to modify those
  899.                screens to show JetMail as a new external command!
  900.  
  901.  
  902.           ***** Option C: (message menu command) *****
  903.  
  904.                This is almost exactly the same as Option B, except the menu
  905.                filename is SFMSG.MNU and the batch file is SFMESS.BAT. You
  906.                may also add JetMail to your File Menu by editing SFFILE.MNU
  907.                and SFFILE.BAT appropriately.
  908.  
  909.  
  910.           6.   It is highly recommended that you make a file that has
  911.                shorter descriptions for the Spitfire message conferences.
  912.                Although Spitfire allows for conference descriptions up to
  913.                40 characters, the QWK format require conference
  914.                descriptions to be no more than 12 characters. HOWEVER,
  915.                after testing several offline readers, it is best to use
  916.                conference names that are 10 characters or less. 
  917.  
  918.                JetMail will look for a text file named CONFLIST.JET in the
  919.                JetMail home directory. If this file exists, JetMail will
  920.  
  921.  
  922.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 14
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.                use the conference names listed in this text file instead of
  930.                the actual Spitfire conference descriptions. This text file
  931.                is just a simple ASCII file, with one conference description
  932.                per line. The line number of each line of text is a
  933.                conference name corresponding to the conference number.
  934.  
  935.                A utility named MAKECONF.EXE comes with the JetMail
  936.                distribution ZIP file to assist you in building the
  937.                CONFLIST.JET file. The syntax for MAKECONF is:
  938.  
  939.                  MAKECONF conf_dat_file [-][word_number]                          conf_dat_file  -  word_number
  940.  
  941.                  Where    conf_dat_file is path and name of SFMCONF.DAT,                          conf_dat_file
  942.  
  943.                    and    word_number   specifies the Nth word to use as                          word_number
  944.                                         short name. If word_number is
  945.                                         negative, only one word for short
  946.                                         name. If word_number is positive,
  947.                                         spaces replaced with underscores.
  948.  
  949.                Example:  
  950.                Spitfire conference names:
  951.                     1 - General Conference
  952.                     2 - Programmers Forum
  953.                     3 - Chit Chat and Small Talk
  954.                     4 - (RIME) Bible Studies
  955.                     5 - (RIME) Common
  956.                     6 - Intelec Net Central
  957.  
  958.                The following examples illustrate how MAKECONF works, if the
  959.                above are the Spitfire conferences' descriptions.
  960.  
  961.                MAKECONF \SF\SFMCONF.DAT      General_Conference
  962.                                              Programmers_Forum
  963.                                              Chit_Chat_and_Small_Talk
  964.                                              (RIME)_Bible_Studies
  965.                                              (RIME)_Common
  966.                                              Intelec_Net_Central
  967.  
  968.                MAKECONF \SF\SFMCONF.DAT 2    Conference
  969.                                              Forum
  970.                                              Chat_and_Small_Talk
  971.                                              Bible_Studies
  972.                                              Common
  973.                                              Net_Central
  974.  
  975.                MAKECONF \SF\SFMCONF.DAT 3    General_Conference
  976.                                              Programmers_Forum
  977.                                              and_Small_Talk
  978.                                              Studies
  979.                                              (RIME)_Common
  980.                                              Central
  981.  
  982.                MAKECONF \SF\SFMCONF.DAT -1   General
  983.                                              Programmers
  984.                                              Chit
  985.                                              (RIME)
  986.  
  987.  
  988.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 15
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.                                              (RIME)
  996.  
  997.                MAKECONF \SF\SFMCONF.DAT -2   Conference
  998.                                              Forum
  999.                                              Chat
  1000.                                              Bible
  1001.                                              Common
  1002.  
  1003.                MAKECONF.EXE will read the Spitfire conference system
  1004.                information SFMCONF.DAT and generate a preliminary
  1005.                CONFLIST.JET containing your conference descriptions.
  1006.                Selecting an appropriate second parameter (the 'word'
  1007.                number) when using MAKECONF will help you build a
  1008.                CONFLIST.JET that will require less editing.
  1009.  
  1010.                After you use MAKECONF, you need to edit this preliminary
  1011.                CONFLIST.JET and adjust all the conference names to be 10
  1012.                characters or less. Perhaps it is difficult to describe
  1013.                conferences in just 10 characters, but do the best you can.
  1014.                You may want to use acronyms or abbreviations.
  1015.  
  1016.  
  1017.           7.   Make sure DSZ.COM (or DSZ.EXE), PKZIP.EXE, PKUNZIP.EXE are
  1018.                in the DOS path. (for example, at the DOS prompt, in the
  1019.                JetMail directory, you should be able to type PKZIP and get
  1020.                the PKZIP help menu, etc.)  Also, likewise, other transfer
  1021.                programs and compression utilities need to be accessible via
  1022.                the DOS path (or explicitly specified in JetMail's
  1023.                configurations accordingly), if you choose to support them.
  1024.  
  1025.                This concludes the installation of JetMail. Refer to the
  1026.                questions and answers section of this documentation if you
  1027.                have other questions. If you have other difficulty in
  1028.                running JetMail after you've followed these installation
  1029.                instructions carefully, and the Q&A section doesn't resolve
  1030.                the complications, please contact the author for technical
  1031.                support.
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 16
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.           JETMAIL SYSTEM FILES          JETMAIL SYSTEM FILES
  1063.           --------------------
  1064.  
  1065.           JetMail has several other features. When JetMail is first opened,
  1066.           it will display an ascii text file JETNEWS, if it exists in the
  1067.           JetMail home directory. This text file is displayed every time
  1068.           the JetMail door is opened.
  1069.  
  1070.           If a new user opens JetMail for the first time, JetMail displays
  1071.           the ascii text file NEWUSER, if it exists in the JetMail home
  1072.           directory. In this text file, you can introduce your users to
  1073.           JetMail door. You may want to tell them how they can download a
  1074.           QWK mail reader, if they don't already have one, and the JetMail
  1075.           User's Guide which you can make available to them as a separate
  1076.           file. This text file will also notify the new JetMail user of the
  1077.           default conferences (ones that you've set up in DEFAULT=)
  1078.           configured automatically for them by JetMail, so that they can
  1079.           download just the last ten messages in those conferences, sort of
  1080.           as an introduction to using the QWK offline mail system.
  1081.  
  1082.           There is help files for three sections of JetMail:  at the main
  1083.           JetMail Command prompt, at the Configuration Setup prompt, and at
  1084.           the Select Conference prompt. The help file is displayed when a
  1085.           question mark (?) is entered. The three files are simple ascii
  1086.           text files located in the JetMail home directory, files are
  1087.           named, respectively, JETHELP.MAI, JETHELP.USR, and JETHELP.SEL.
  1088.           These may be edited if you wish to give more details on certain
  1089.           commands. 
  1090.  
  1091.           The JetMail main menu, JETMENU.BBS and JETMENU.CLR may be edited.
  1092.           Don't leave out any commands!  The .CLR is the ANSI/graphics
  1093.           version, and the .BBS is the ascii/non-graphics version, same as
  1094.           Spitfire's notation.
  1095.  
  1096.           JETMAIL.ID is a file distributed with JetMail which will be
  1097.           included as the DOOR.ID in the .QWK packets downloaded from
  1098.           JetMail. Some readers will be able to use this file for offline
  1099.           configuration messages. The next release of SLMR is proposed for
  1100.           full JetMail compatibility.
  1101.  
  1102.  
  1103.           USING JETMAIL          USING JETMAIL
  1104.           -------------
  1105.  
  1106.           JetMail is very easy to use. If you are familiar with using .QWK-
  1107.           compatible doors on PCBoards, JetMail should be very familiar to
  1108.           you. Some Spitfire-specific nuances will be explained here. For a
  1109.           more detailed guide on using JetMail as a user, refer to the
  1110.           JetMail User's Guide.
  1111.  
  1112.           Spitfire's BBS structure is different than PCBoard's. This comes
  1113.           into play when building a .QWK-format mail packet, which was
  1114.           designed for best fit with PCBoard. PCBoard has only one welcome
  1115.           screen (ascii or color), one NEWS screen (the file displayed
  1116.           after password entry on PCBoard and before Mail scan), and one
  1117.           goodbye screen. Spitfire allows multiple files to be displayed to
  1118.  
  1119.  
  1120.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 17
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.           the user after password entry. The Spitfire sysop will need to
  1128.           decide which of these files gets packed into the .QWK packet for
  1129.           the user to keep up with the latest happenings on the BBS.
  1130.  
  1131.           The purpose of a PCBoard NEWS file is to let the user know what
  1132.           is happening with the BBS daily or periodically; I don't know of
  1133.           the exact equivalent for Spitfire. The Newsletter feature might
  1134.           be similar, but I don't know of too many Spitfire sysops that
  1135.           updates their Newsletter frequently. You have the option of
  1136.           enclosing your Newsletter, one of the daily-updated screens like
  1137.           times of network transfers, or a recent callers list. Whatever
  1138.           file you want to include in the .QWK packet, just specify it with
  1139.           the NEWS= parameter in the JetMail configuration. If you want to
  1140.           enclose one of the WELCOME<x>.BBS files, just specify the path
  1141.           and filename of the WELCOME<x>.BBS file using parameter NEWS= in
  1142.           the JetMail configuration file. If you have multiple
  1143.           WELCOME<x>.BBS screens which you'd like to put in the .QWK
  1144.           packet, you can use DOS' COPY command to append all the .BBS
  1145.           files together into one file, using:
  1146.  
  1147.                COPY WELCOME2.BBS+WELCOME3.BBS+WELCOME4.BBS WELNEWS
  1148.  
  1149.           The above line can be placed in your JetMail batch file, or in
  1150.           your system event. And specify WELNEWS as your NEWS= parameter.
  1151.           JetMail does not use the .CLR version of the file specified in
  1152.           the NEWS= parameter.
  1153.  
  1154.           JetMail will only scan messages from the list of conferences
  1155.           selected by in JetMail's Select Conferences menu. JetMail's
  1156.           selection menu allows the user to copy the conference queue from
  1157.           Spitfire for convenient configuration, if desired.
  1158.  
  1159.           JetMail takes into account many Spitfire system configured
  1160.           variables, such as security level to access a conference, sysop
  1161.           security level for a conference, public or private messages, and
  1162.           whether the message is deleted (deleted messages remain in the
  1163.           Spitfire message base; they are only flagged until the next
  1164.           message pack command is executed.)  This assures that only
  1165.           messages that a user is allowed to access will be accessed.
  1166.           Likewise measures are placed on user's reply packet:  public-only
  1167.           conferences, and security level access to a conference. If a user
  1168.           tries to post a private message in a public-only conference, the
  1169.           message will be ignored and not posted. If a user tries to post a
  1170.           message in a conference to which he has no access, that message
  1171.           will not be posted.
  1172.  
  1173.           JetMail will also place a copy of the most recent .QWK packet
  1174.           generated into the JetMail home directory, for both local and
  1175.           remote use. If something got lost during the COPY command during
  1176.           local use, check the JetMail home directory for a .QWK packet. 
  1177.  
  1178.           JetMail will automatically write to the Spitfire's caller log
  1179.           (CALLER.TMP in the Spitfire home directory), except if the LOG=
  1180.           parameter is specified. Spitfire will appropriately append
  1181.           CALLER.TMP into the total CALLER.LOG in the Spitfire work
  1182.           directory. Messages posted, messages found during new messages
  1183.           scan, and JetMail error messages are all recorded. A shareware
  1184.  
  1185.  
  1186.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 18
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.           reminder is also recorded in the caller log, reminding you to
  1194.           send in your registration after evaluation, if you are satisfied
  1195.           with the product. Upon registration, this reminder will be
  1196.           removed from the caller log, as well as the extra JetMail tagline
  1197.           appended on messages posted via JetMail.
  1198.  
  1199.  
  1200.           WHILE ONLINE          WHILE ONLINE
  1201.           ------------
  1202.  
  1203.           While the user is using JetMail, the two bottom lines display his
  1204.           (or her) status. It shows the node number, baud rate, user name
  1205.           in the left half of the first line; the current time and time
  1206.           when door was entered on the right half of the first line. On the
  1207.           second line, it shows the date and user security level. The right
  1208.           half of the second line shows the version number of JetMail.
  1209.  
  1210.           Function keys available to the sysop while in JetMail:
  1211.  
  1212.           ALT-H  Display HELP on status lines at bottom of screen
  1213.                  (toggles between several screens; last screen gives
  1214.                  comm port status)
  1215.           F5     Shell to DOS (when in DOS, be sure to return to the
  1216.                  JetMail directory before EXIT)
  1217.           F8     Return user to BBS (quits JetMail immediately)
  1218.           F9     Toggle display on/off
  1219.           F10    Chat mode (hit ESC to exit chat mode)
  1220.  
  1221.           All other keys are processed by JetMail as 'normal' keystrokes.
  1222.           In the Help status screen (ALT-H), F3, F4, and F7 are labeled
  1223.           with certain functions, however, these functions are only used by
  1224.           the CKIT door-writing toolkit for PCBoard, and I can't remove
  1225.           them even for aesthetic sake.
  1226.  
  1227.  
  1228.           JETMAIL AUTO-PILOT          JETMAIL AUTO-PILOT
  1229.           ------------------
  1230.  
  1231.           JetMail has a special feature called Auto-Pilot, which can be
  1232.           used in your system event or from the DOS command line for you to
  1233.           quickly post your replies from an .REP packet, if any, and to
  1234.           scan for new messages and put them in a .QWK packet, without
  1235.           logging into Spitfire.
  1236.  
  1237.           To run JetMail Auto-Pilot, you first must login to Spitfire as
  1238.           sysop locally, and run JetMail door. When you're in JetMail door,
  1239.           hit F5 to shell to DOS from JetMail, and make a copy of the
  1240.           DOOR.SYS in the Spitfire home directory and keep it for Auto-
  1241.           Pilot use. This file must be called DOOR.SYS.... (You can call
  1242.           this file AUTOJET.SYS, and put it into the JetMail home
  1243.           directory. Then in your system event, or from the command line,
  1244.           you can invoke JetMail's Auto-Pilot mode:
  1245.  
  1246.                COPY AUTOJET.SYS DOOR.SYS
  1247.                JETMAIL DOOR.SYS EVENT
  1248.  
  1249.           This command line will use JETMAIL.CNF in the JetMail home
  1250.  
  1251.  
  1252.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 19
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.           directory; if you need to specify a different JetMail
  1260.           configuration .CNF file, you can do that like this: 
  1261.  
  1262.                COPY AUTOJET.SYS DOOR.SYS
  1263.                JETMAIL DOOR.SYS JETNODE1.CNF EVENT
  1264.  
  1265.           The name of the DOOR.SYS is not important, but EVENT is - EVENT
  1266.           puts JetMail into Auto-Pilot mode.
  1267.  
  1268.           When using JetMail Auto-Pilot, JetMail will look for a .REP
  1269.           packet in the directory which you specified in the JetMail
  1270.           configuration's LOCALDIR= parameter. If this parameter is not
  1271.           specified, you need to specify a drive and directory if you want
  1272.           to use Auto-Pilot mode.
  1273.  
  1274.           If JetMail finds a .REP packet in the LOCALDIR= directory,
  1275.           JetMail will post the messages from that .REP into the
  1276.           appropriate Spitfire conferences. If no .REP is found, JetMail
  1277.           will continue on to the New Messages scan.
  1278.  
  1279.           Then JetMail will scan for new messages in the conferences. If
  1280.           there are new messages, JetMail will build a new .QWK packet, and
  1281.           place it in the LOCALDIR= directory. If a BBSID.QWK (where BBSID
  1282.           is your BBS' ID) already exists in the LOCALDIR= directory,
  1283.           JetMail will automatically name the new QWK packet with the
  1284.           extension .QW0. If there is already a .QW0, JetMail will
  1285.           increment the last digit, and try .QW1, then .QW2, until it can
  1286.           find an available filename, up to 9. If JetMail is unable to find
  1287.           an available filename, JetMail should return with an error and
  1288.           not write the new messages in a .QWK packet.
  1289.  
  1290.           After a .QWK containing new messages is placed in the LOCALDIR=
  1291.           directory, JetMail will update the Last Message Read pointers of
  1292.           the conferences with new messages found.
  1293.  
  1294.           JetMail Auto-Pilot concludes and returns to DOS (or the batch
  1295.           file that called it, as the case may be).
  1296.  
  1297.  
  1298.           LOCAL JETMAIL USE          LOCAL JETMAIL USE
  1299.           -----------------
  1300.  
  1301.           Local usage of JetMail is automatically recognized. When the user
  1302.           (or sysop) is ready to transfer a packet, instead of invoking an
  1303.           external protocol, JetMail will prompt the user for a directory
  1304.           where the packet is located (or where to put the newly generated
  1305.           .QWK packet). Just enter the drive and path, and JetMail will
  1306.           place the packet there (or get the packet from the path
  1307.           specified). During local Download, if a .QWK already exists at
  1308.           the destination path, JetMail will prompt "Overwrite? [Y/N/I]".
  1309.           If you answer Yes, JetMail will overwrite the existing .QWK with
  1310.           the newly generated .QWK; if you answer No, JetMail will place
  1311.           the newly generated .QWK in the JetMail home directory; if you
  1312.           answer "I", JetMail will automatically try a new name for the
  1313.           newly generated BBSID.QWK, first trying BBSID.QW0, then
  1314.           BBSID.QW1, up to BBSID.QW9. If JetMail is unable to find an
  1315.           available filename, JetMail doesn't attempt to copy BBSID.QWK to
  1316.  
  1317.  
  1318.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 20
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.           the destination path. It will still leave a copy of the BBSID.QWK
  1326.           in the JetMail home directory.
  1327.  
  1328.  
  1329.           COMMAND-LINE USE OF JETMAIL          COMMAND-LINE USE OF JETMAIL
  1330.           ---------------------------
  1331.  
  1332.           If you would like to be able to login to JetMail without logging
  1333.           into Spitfire, you can use a similar technique as the auto-pilot
  1334.           described above, except you don't specify the EVENT parameter to
  1335.           JetMail. (you may use the same DOOR.SYS for JetMail auto-pilot as
  1336.           you do for local command-line JetMail).
  1337.  
  1338.           Just login to Spitfire as you normally would, shell to DOS using
  1339.           ALT-J in Spitfire (or F5 in JetMail), make a copy of DOOR.SYS in
  1340.           the Spitfire directory to LOCAL.SYS and place LOCAL.SYS in the
  1341.           JetMail home directory, then logout. Then you can make a batch
  1342.           file, call it JET.BAT, containing:
  1343.  
  1344.                COPY LOCAL.SYS DOOR.SYS
  1345.                JETMAIL DOOR.SYS
  1346.  
  1347.           You can then login to JetMail by typing JET at the DOS prompt,
  1348.           then go directly into JetMail without a Spitfire login. You can
  1349.           get fancy and use a separate .CNF config file with a different
  1350.           LOG= parameter, so that your JetMail activity is redirected to a
  1351.           separate file, if you wish to have your personal JetMail usage to
  1352.           not be logged to the total Spitfire caller log. (or discard this
  1353.           separate log if you don't want to have a record of your
  1354.           activity).
  1355.  
  1356.  
  1357.           MULTI-NODE USE OF JETMAIL          MULTI-NODE USE OF JETMAIL
  1358.           -------------------------
  1359.  
  1360.           JetMail can work on a multi-node Spitfire system. JetMail can
  1361.           share the JETMAIL.EXE file, the help files, menu screens, and the
  1362.           JetMail users database (USERS.JET). JetMail uses share-compatible
  1363.           routines to access the Spitfire system files and Spitfire
  1364.           messages files - BUT this must be activated by specifying the
  1365.           JetMail .CNF configuration file to use on the JetMail command
  1366.           line.
  1367.  
  1368.           THIS IS VERY IMPORTANT! To run JetMail on a multi-node system,
  1369.           you must have a SEPARATE JetMail configuration file for each node
  1370.           and a SEPARATE temporary work directory for each node. 
  1371.  
  1372.           To minimize confusion, you can name the configuration files
  1373.           JETNODE1.CNF and JETNODE2.CNF. Be sure to specify the
  1374.           configuration file in the JetMail command line in your door batch
  1375.           file or your sysop configured external command batch file
  1376.           (SFMAIN.BAT or SFMESS.BAT.)  NOTE: JetMail configuration files
  1377.           must have the .CNF extension!
  1378.  
  1379.           Be sure you have different WORKDIR= specified for each node's
  1380.           JetMail configuration.
  1381.  
  1382.  
  1383.  
  1384.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 21
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.           If you're in a network environment, make sure you have the
  1392.           correct drive letters for the JetMail batch files, and the
  1393.           configuration files WELCOME=, NEWS=, and GOODBYE= parameters.
  1394.  
  1395.  
  1396.  
  1397.           JETMAIL SYSTEM MANAGER          JETMAIL SYSTEM MANAGER
  1398.           ----------------------
  1399.  
  1400.           JETSM.EXE is the system editor which manages many JetMail
  1401.           functions. There are four basic sections: Edit Configuration,
  1402.           Transfer Protocols, User Editor, and Adjust Conferences.
  1403.  
  1404.           The Edit Configuration will edit JETMAIL.CNF in the current
  1405.           directory. This is to assist your editing the .CNF configuration
  1406.           file for JetMail, but it is by no means comprehensive. For
  1407.           initial configuration, this may be very helpful in getting
  1408.           JetMail up and running; however, if you need to adjust JetMail's
  1409.           operation for your particular system, please use a text editor
  1410.           and enter the parameters as described in this documentation.
  1411.           Multi-node systems will also need to be configured manually; but
  1412.           this JETSM feature may still be useful in setting up a
  1413.           preliminary .CNF file from which you can build into .CNF's for
  1414.           each node. (Reminder again, each node of a multi-node system must
  1415.           have its own .CNF configuration file and its own temporary
  1416.           JetMail work directory)
  1417.  
  1418.           The Transfer Protocols editor works in a similar fashion - it is
  1419.           designed to let you quickly edit the JETXFER.DAT in an easy-to-
  1420.           understand full screen editor. You should be able to define all
  1421.           your transfer protocols here, but again, use a text editor if you
  1422.           find JETSM's Transfer Protocol editor insufficient.
  1423.  
  1424.           The User Editor portion allows you to edit the user configuration
  1425.           for a JetMail user, give NetSysop access to the conferences if
  1426.           you are running JetMail as a network hub, and allows you to add
  1427.           or delete users. The editor is pretty straight-forward and simple
  1428.           to use.
  1429.  
  1430.           The Adjust Conferences portion allows you to quickly add or drop
  1431.           conferences from all JetMail users' configuration. This would be
  1432.           used when you have added several conferences that you want all
  1433.           users to read from. You may also want to drop (remove users from
  1434.           some conferences) when you change your conferences around.
  1435.  
  1436.           All four portions of the System Manager are full-screen user
  1437.           interfaced, so they should be pretty straight forward to use.
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 22
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.           The function keys available in JETSM are (as applicable):
  1458.  
  1459.            Tab           moves to next field
  1460.            Shift-Tab     moves to previous field 
  1461.            Alt-A         add a new user record
  1462.            Alt-D         delete a user record
  1463.            F2            toggle between high and low conference numbers
  1464.                          (screen one is 1-128, screen two is 129-255)
  1465.            PgUp          move to previous record
  1466.            PgDn          move to next record
  1467.            F10           save changes and return to main menu
  1468.            Esc           abort program and leave user database unchanged
  1469.  
  1470.            Alt-Z         Jump to "Undo" field, and hitting <~> in this
  1471.                          box zaps (undos) any changes made on that screen
  1472.            Alt-C         Jumps to first conference number field
  1473.            Alt-L         Jumps to last conference number field
  1474.            Alt-U         Jumps to user name field
  1475.  
  1476.            Cursor Up     Moves to the previous field
  1477.            Cursor Down   Moves to next field
  1478.            Insert        Toggle between insert and typeover mode
  1479.            Ctrl-R        Restore field to original value
  1480.            Ctrl-bkspace  Delete word left
  1481.            Ctrl-T        Delete word right
  1482.            Ctrl-U        Delete to end of field
  1483.  
  1484.           A hint bar at the bottom of the User Editor screen may be
  1485.           referenced for available functions. Reminder: the field labeled
  1486.           "Format" refers to the compression format NUMBER, the field
  1487.           labeled "Protocol" refers to the LETTER of the transfer protocol
  1488.           designator, and the field "Max Size" is the maximum number of
  1489.           messages to scan into a .QWK packet.
  1490.  
  1491.           In the lower half of the screen, you can select conferences for
  1492.           the user, overriding any forced and default conferences you've
  1493.           configured for JetMail. You could also override Spitfire security
  1494.           level for private conferences, but please do NOT do this as
  1495.           JetMail will have unpredictable results. (You can toggle off
  1496.           scanning forced conferences for NetSysops so they can expedite
  1497.           mail run transfers, when you run JetMail as a network hub).
  1498.  
  1499.           JetMail allows you to setup for up to 20 networks. The field
  1500.           marked "NetSysop" located at the bottom right of the screen can
  1501.           be used for giving the user/sysop NetSysop access. The NetSysop
  1502.           field contains two lines of ten characters, each character
  1503.           corresponding to the network number. An 'X' in the first
  1504.           character of the first line corresponds to network number 1; an
  1505.           'X' in the sixth character first line corresponds to net number
  1506.           6; an 'X' in the first character of the second line corresponds
  1507.           to net number 11; an 'X' in the tenth character of the second
  1508.           line corresponds to net number 20; etc. Spaces in the field mean
  1509.           the user/sysop does not have NetSysop access to that network.
  1510.  
  1511.           For each echo mail network, you need to generate a text file
  1512.           containing the numbers of the conferences which comprise that
  1513.           network; the network conference list should have one number per
  1514.  
  1515.  
  1516.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 23
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.           line. These network lists need to be placed in the JetMail home
  1524.           directory, with filenames NETLIST.<x>, where <x> is the network
  1525.           number (with no leading zeros). For example, if you had two
  1526.           networks, with conferences 20-24 in network 1, and conferences
  1527.           34-37 in network 2, you would have two text files:
  1528.  
  1529.           NETLIST.1                NETLIST.2
  1530.           ---------                ---------
  1531.           20                       34
  1532.           21                       35
  1533.           22                       36
  1534.           23                       37
  1535.           24
  1536.  
  1537.           "Cross-echos", conferences that are shared on multiple networks,
  1538.           may be supported by listing a conference number in more than one
  1539.           network conference list.
  1540.  
  1541.           Here are the differences in JetMail for a user/sysop with
  1542.           NetSysop access:  the JETNEWS is not displayed, JetMail defaults
  1543.           to menu expert mode (no menu, for the most expedient mail runs),
  1544.           .REP files may contain messages from different users and JetMail
  1545.           will post them as such (non-NetSysop users can only post messages
  1546.           from themselves), and NetSysop will scan into the .QWK all new
  1547.           messages in a network conference, regardless of scan flag (Y or
  1548.           YA or ALL), and access any private messages in the network
  1549.           conference.
  1550.  
  1551.           NOTE:  If you configure a JetMail user/sysop for multiple
  1552.           networks (more than one 'X' in the NetSysop field), the network
  1553.           software that the node sysop is using must be able to handle
  1554.           multiple networks. If the network software used to process .QWK's
  1555.           received from JetMail can only process one network at a time, you
  1556.           will need to setup separate accounts for each network mail run.
  1557.  
  1558.  
  1559.           JETMAIL AS A NETWORK HUB          JETMAIL AS A NETWORK HUB
  1560.           ------------------------
  1561.  
  1562.           JetMail may be used as a hub for QNet-compatible networks. To be
  1563.           a hub for a network, you do not need to change the JetMail .CNF
  1564.           configuration file. Basically, only two steps are involved:  give
  1565.           the sysop(s) that are running as nodes off of your hub Network
  1566.           Sysop (NetSysop) access in JetMail, and define which conferences
  1567.           comprise the network.
  1568.  
  1569.           To give NetSysop access to a user/sysop in JetMail, use the JETSM
  1570.           user editor, setting the appropriate flags under the "NetSysop"
  1571.           field for the corresponding user. Be sure to hit F10 to exit
  1572.           JETSM to save the changes.
  1573.  
  1574.           The node sysop is unable to set his own NetSysop status.
  1575.           Certainly, you don't want any user to be able to toggle on
  1576.           NetSysop status, which have the effects described above. You as a
  1577.           network hub have responsibility to manage your nodes. Please be
  1578.           sure to uphold the regulations of the echo mail network of which
  1579.           you are a member. However, the NetSysop will be able to add/drop
  1580.  
  1581.  
  1582.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 24
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.           conferences (using a JetMail offline config message) in the
  1590.           network to which he has NetSysop access, so he can add/drop
  1591.           network conferences without your intervention.
  1592.  
  1593.           You may want to setup an entirely separate account for each sysop
  1594.           making network transfers via JetMail. This will allow the node
  1595.           sysop to maintain a separate account on your board for reading
  1596.           messages from non-network conferences and keep the records
  1597.           straight between network activity and user activity.
  1598.  
  1599.           JetMail supports up to 20 distinct networks. You need to list in
  1600.           a simple ASCII file the network conferences, in NETLIST.<x>,
  1601.           where <x> is the network number (no leading zeros).
  1602.  
  1603.           When a Network Sysop logs in to JetMail, he will default to
  1604.           expert mode, so no menus are sent and no JETNEWS is displayed.
  1605.           After JetMail's initialization, the Network Sysop status is shown
  1606.           -- JetMail shows what networks he is configured for. During the
  1607.           message scan, a "#" (pound sign) will be shown on the left column
  1608.           by the conference numbers to which he has network access.
  1609.  
  1610.           As a Network Sysop, he is given access to "private" messages in
  1611.           the network conferences. He will also be able to post messages
  1612.           from anyone (normally, JetMail will post messages from an .REP as
  1613.           from the logged on user, regardless of what is actually put in
  1614.           the .REP packet, as a security measure).
  1615.  
  1616.           Also, recommend to the NetSysop node sysop to toggle off any
  1617.           unnecessary flags in JetMail. Generally speaking, the node sysop
  1618.           does not need to include Welcome and Goodbye screens in his .QWK
  1619.           packet, doesn't need new files and new bulletins, and depending
  1620.           on the network software they're using, they may not need .NDX
  1621.           index files. Also, set the parameters for the maximum number of
  1622.           messages appropriately. Some network softwares may be able to
  1623.           handle more than 200 messages per conference.
  1624.  
  1625.           As a hub, JetMail does not add network origin taglines. The
  1626.           network software must append host taglines appropriately.
  1627.  
  1628.           Details on operating (or starting) an echo mail networks are not
  1629.           explained here. JetMail can facilitate the generation of .QWK's
  1630.           that can be used by QNet-compatible softwares (like QNet, RNet,
  1631.           TNet, RoseMail, MKNet, TriNet), and this documentation gives you
  1632.           the fundamental details on using JetMail for this purpose.
  1633.           Development of a QNet-compatible software for Spitfire is
  1634.           currently in progress.
  1635.  
  1636.  
  1637.           REGISTRATION & SUPPORT          REGISTRATION & SUPPORT
  1638.           ----------------------
  1639.  
  1640.           Registration for JetMail is $25.00 (US funds please). This amount
  1641.           may be paid by the sysop using JetMail, or by a user wishing to
  1642.           adopt the door for a sysop. Sysop-fundeded and user-adopted door
  1643.           registrations may download a custom regline (a regline is a line
  1644.           of text that is displayed when JetMail door is opened, indicating
  1645.           to whom the door is registered, for example: Registered to Solid
  1646.  
  1647.  
  1648.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 25
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.           Rock BBS) that will be displayed upon opening JetMail door from
  1656.           the distribution board.
  1657.  
  1658.           Registration should be made promptly during the 30-day evaluation
  1659.           period if JetMail performs to your satisfaction. Registration
  1660.           will remove the extra JetMail tagline appended to messages posted
  1661.           in JetMail, and removes the reminder notice in the caller log.
  1662.           There is no extra delays, no crippled features, or gaudy flashing
  1663.           unregistered notices in the unregistered version of JetMail. 
  1664.  
  1665.           If you would like to receive a disk with a custom regline, the
  1666.           latest version of the software (which may or may not be the one
  1667.           that you already have), and the documentation in WordPerfect
  1668.           format, please add $5.00 to your payment (totaling $30.00), and I
  1669.           will mail you the latest JetMail software on your choice of media
  1670.           (5 " or 3 " floppy).
  1671.  
  1672.           This documentation is originally written in WordPerfect 5.1
  1673.           format. The documentation can be obtained in WordPerfect format
  1674.           upon registration if you would like to get it for printing on a
  1675.           laser printer or something. This will be available for JetMail
  1676.           sysops on Solid Rock BBS, or on above mentioned disk.
  1677.  
  1678.           Your registration will be promptly processed; after I receive
  1679.           your registration, you will receive access on Solid Rock BBS to
  1680.           download your registration key file, or you will receive a disk
  1681.           with the key file if you selected this option. Mail registration
  1682.           form (REGISTER.JET) and payment to:
  1683.                                              DJ Chuang
  1684.                                              3909 Swiss Ave., #264
  1685.                                              Dallas, TX  75204
  1686.  
  1687.           The latest JetMail may be downloaded from:
  1688.           * The Solid Rock, [CircuitNet; NewLife, RIME, Intelec ->SOLIDRCK]
  1689.             sysop Ron Hossack, running Spitfire 3.1
  1690.             (714)785-9176 HST 14.4
  1691.           * SMCIS, [NewLife, RIME ->SMCIS]
  1692.             sysop Buggs Bugnon, running PCBoard 14.5
  1693.             (301)862-3160 HST 14.4, (301)862-1527 HST/DS
  1694.           * Sing Sing BBS, [Intelec ->SINGSING]
  1695.             sysop Ira Lichtenstein, running Spitfire 3.1
  1696.             (914)941-2246 (2400)
  1697.           * The Paradigm, [RIME ->PARADIGM]
  1698.             sysop Tom Kellen, running Spitfire 3.1
  1699.             (404)671-1581 HST
  1700.           * Columbia Spitfire [CircuitNet]
  1701.             sysop Steve Newman, running Spitfire 3.1
  1702.             (503)397-5486 HST/DS, (503)397-6040 HST
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 26
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.           Before contacting the author with questions and/or problems, be
  1723.           sure you understand the included documents and have referred to
  1724.           the questions and answers section to try to resolve the problem.
  1725.           If you feel there is a definite bug in JetMail, please contact
  1726.           the author immediately. The best contact is the main distribution
  1727.           board, Solid Rock BBS. The sysop there (Ron Hossack) will forward
  1728.           all messages to me. Ron Hossack will be able to help you with
  1729.           Spitfire specific questions. I can be contacted via e-mail on the
  1730.           RelayNet/RIME network (Conferences: Mail Doors, Common,
  1731.           Offline/Connection, Spitfire), ILink (Offline), PlanoNet
  1732.           (Reviews), FidoNet (Spitfire echo); address messages to me (DJ
  1733.           CHUANG) directly with your questions and suggestions. You may
  1734.           also write me via Fido net-mail at 1:124/6300, and also (when
  1735.           available) on Internet at dj.chuang@u2u.lonestar.org.
  1736.  
  1737.  
  1738.           AUTHOR NOTES & THANKS          AUTHOR NOTES & THANKS
  1739.           ---------------------
  1740.  
  1741.           Special thanks to Buggs Bugnon and Ron Hossack for their faith
  1742.           and support. Also thanks to Ron (again) and John Clawson for
  1743.           suggesting the idea. And thanks to alpha site sysops Ron, Ira,
  1744.           Tom, and Steve.
  1745.  
  1746.           Special thanks to the beta testers that really 'tortured' JetMail
  1747.           to refine it into the product that it is today:
  1748.                Ron Hossack
  1749.                Ira Lichtenstein
  1750.                Tom Kellen
  1751.                Steve Newman
  1752.                Wayne Browning
  1753.                John Clawson
  1754.                Doug Klassen
  1755.                Jose Frias
  1756.  
  1757.           Version 1.10 took considerably more time for development, as now
  1758.           I am working part-time (manual labor) and attending school full-
  1759.           time. I appreciate the words of encouragement from JetMail users
  1760.           all over the world, and I'm glad that I'm able to serve the
  1761.           Spitfire community in such a manner. (I hope you don't mind the
  1762.           less-detailed documentation, I get tedious writing more, as well
  1763.           as you might get tedious reading it! *grin*)
  1764.  
  1765.           Most of all, all praise and glory to God Almighty, the Creator of
  1766.           the heavens and the earth; the triune and eternal One; who has
  1767.           provided eternal life by grace through faith in Jesus Christ
  1768.           (John 3:16; 14:6). [Don't mean to be preachin', but I need the
  1769.           practice, and have to be specific these days]
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 27
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.           ACKNOWLEDGEMENTS          ACKNOWLEDGEMENTS
  1789.           ----------------
  1790.           * CKIT is copyright by Rickie W. Belitz.
  1791.           * TURBO C/C++ is a registered trademark of Borland International
  1792.             Inc.
  1793.           * PCBoard is a registered trademark of Clark Development Company.
  1794.           * SPITFIRE is a trademark of Buffalo Creek Software, copyright by
  1795.             Mike Woltz.
  1796.           * PKZIP/PKUNZIP are copyright PKWare and Phil Katz.
  1797.           * DSZ is copyright by Omen Technology, Inc.
  1798.           * WordPerfect is copyright WordPerfect Corporation.
  1799.           * FATAL and PROECHO are copyright by Samuel H. Smith.
  1800.           * SFUTI is copyright by Bob Browne.
  1801.           * WildFire is copyright by Stephen L. Cox.
  1802.           * QMail Deluxe and QNet are trademarks of Sparkware, copyright by
  1803.             Mark Herring.
  1804.           * SLMR and TNet are trademarks of Technique Computer Systems,
  1805.             copyright by Greg Hewgill.
  1806.           * EZ-Reader is a trademark of Thumper Technologies, copyright by
  1807.             Eric Cockrell.
  1808.           * RoseMail and RoseReader are copyright by Vic Kass.
  1809.           * Session Manager is copyright by Patrick W. Hart.
  1810.           * MegaMail door and MegaMail Reader is copyright by Kip Compton.
  1811.           * KingQWK is copyright by Mike King.
  1812.           * Speed Read is copyright by Jim Smith.
  1813.           * Power-QWK is copyright by Gale Green.
  1814.           * WinQwk is copyright by Doug Crocker.
  1815.           * WinRead is copyright by Ollivier Civiol.
  1816.           * RNet is copyright by Robert Vostreys.
  1817.           * MKNet is copyright by Mark May.
  1818.           * TriNet is copyright by Mark Goodwin.
  1819.           * JetMail is copyright by DJ Chuang. (obviously)
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 28
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.           
  1854.           QUESTIONS AND ANSWERS          QUESTIONS AND ANSWERS
  1855.           ---------------------
  1856.  
  1857.           Q:   Why do I have a directory in my JetMail home directory named
  1858.                TMP1.$$$ ?
  1859.  
  1860.           A:   Sometimes when JetMail shuts down due to a fatal error, and  
  1861.                you're not using an explicitly specified work directory
  1862.                (which may be specified by WORKDIR= in the JetMail
  1863.                configuration file) may find subdirectories in the \JETMAIL
  1864.                directory (i.e. \JETMAIL\TMP1.$$$). The files within these
  1865.                directories may be deleted and the directories removed.
  1866.  
  1867.           Q:   What are the funny ! % * symbols that show up in the Select
  1868.                Conferences menu?
  1869.  
  1870.           A:   JetMail allows several different types of message scans: 
  1871.                for conferences setup for "YA" scan, that is, messages
  1872.                addressed to the current JetMail user and to "All Users", a
  1873.                "%" sign shows up next to the conference number. A "*" means
  1874.                scan for all new messages. And a "!" means the conference is
  1875.                being forced by the sysop, so that the user must scan those
  1876.                conferences for messages. 
  1877.  
  1878.           Q:   What is USERS.JET?
  1879.  
  1880.           A:   JetMail makes a USERS.JET users database file in the JetMail
  1881.                home directory to keep the users configuration, which
  1882.                contains information such as selected conferences, transfer
  1883.                protocol, compression utility, and other flags. You may use
  1884.                JETSM.EXE to edit this file.
  1885.  
  1886.           Q:   JetMail "locks up" after a file transfer. The local screen
  1887.                is still normal and active, but the remote user gets a
  1888.                garbled screen and cannot enter commands.
  1889.  
  1890.           A:   You need to check your system's modem configuration. If
  1891.                Spitfire is setup for Software Flow Control, you need to add
  1892.                a parameter in the JetMail .CNF file:  SPEED=ACTUAL. Also,
  1893.                you need to make sure you're not using something like: 
  1894.  
  1895.                ECHO Message >COM1  
  1896.  
  1897.                in your transfer batch files. The standard DOS echo routine
  1898.                does not properly handle remote communications. If you still
  1899.                want to echo a message in the external transfer batch file
  1900.                to the remote user, please use PROECHO from Sam Smith, which
  1901.                can be downloaded from Solid Rock BBS.
  1902.  
  1903.           Q:   JetMail's message scan comes up with tremendously huge
  1904.                message number, like 1387204, when there's only 200 messages
  1905.                in the conference.
  1906.  
  1907.           A:   JetMail uses the actual unique message number in scanning
  1908.                messages; JetMail does not 'normalize' message numbers like
  1909.                Spitfire does. (Spitfire will number messages according to
  1910.  
  1911.  
  1912.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 29
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.                how many actually exist, so if there are 20 messages in the
  1920.                conference, Spitfire numbers the messages from 1 to 20; but
  1921.                JetMail numbers the messages according to how many messages
  1922.                had been posted on the BBS). Please contact the support BBS
  1923.                for a message renumbering utility to alleviate this.
  1924.  
  1925.           Q:   JetMail has an "Share Violation" error.
  1926.  
  1927.           A:   Is SHARE loaded on your computer?  Also, be sure the JetMail
  1928.                .CNF configuration file is specified on the JetMail command
  1929.                line, even if you are using the default configuration
  1930.                filename of JETMAIL.CNF. Specifying a .CNF file on the
  1931.                JetMail command line activates SHARE aware code in JetMail.
  1932.                So, especially if you are running a single node BBS, 
  1933.                JetMail was developed with MS-DOS 5.0, and has run
  1934.                successfully on systems with DOS 5.0, DOS 4.x, DOS 3.3, and
  1935.                4DOS 3.3. A very useful utility, FATAL.COM by Sam Smith, may
  1936.                be loaded on your system to watch out for share violations
  1937.                and keep them from 'hanging up' your system. FATAL detects
  1938.                the "Abort, Retry, Ignore" prompt and handles them so it
  1939.                doesn't 'hang up' your BBS. 
  1940.  
  1941.           Q:   I got a JetMail error message. What now?
  1942.  
  1943.           A:   Refer to the JETMAIL.FIX document to see what common
  1944.                solutions might be for JetMail errors. 
  1945.  
  1946.           Q:   JetMail doesn't seem to be using the parameters specified in
  1947.                the .CNF configuration file which I specified on the command
  1948.                line when calling JetMail.
  1949.  
  1950.           A:   Be sure the .CNF file exists in the JetMail home directory
  1951.                (note: JetMail configuration files must have the extension
  1952.                .CNF)  Be sure parameter names are UPPER case, and no spaces
  1953.                after the = sign.
  1954.  
  1955.           Q:   How do I install JetMail under the WildFire menu manager?
  1956.  
  1957.           A:   JetMail can be installed in WildFire; just add JetMail as a
  1958.                new entry in the WildFire menu system. Run the LSEDIT.EXE
  1959.                program, select "Script Edit" from the menu bar, "Add New
  1960.                Door Script" on the pull down menu, enter JETMAIL as the
  1961.                unique door name, Door Type should be "S" for Spitfire, set
  1962.                the remainder of the door parameters as appropriate, then
  1963.                edit the script for JetMail:  be sure to change directory to
  1964.                the JetMail home directory, and run JetMail with the correct
  1965.                path to DOOR.SYS and correct JetMail .CNF configuration.
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 30
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.           JETMAIL DOCUMENTATION INDEX
  1987.  
  1988.           .QWK packet  19, 20               PACK1=  11
  1989.           .REP packet  19, 20               PACK1QWK=  11
  1990.           ADDNEWS=  8                       PACK1REP=  11
  1991.           AFTER=  10                        PACK2=  11
  1992.           Auto-Pilot  19, 20                PACK2QWK=  11
  1993.           BBS ID  3                         PACK2REP=  11
  1994.           BBSID=  7                         PACK3=  11
  1995.           Caller log  18                    PACK3QWK=  11
  1996.           Compression Utilities  11         PACK3REP=  11
  1997.           Conference names  14              PKUNZIP.EXE  16
  1998.           CONFLIST.JET  5, 14, 16           PKZIP.EXE  11, 16
  1999.           DEFAULT=  9, 17                   PRIORITY=  10
  2000.           DONTPOST=  9                      Registration  25
  2001.           DOOR.SYS  5                       Regline  25, 26
  2002.           DOS path  16                      SF.BAT  13
  2003.           EVENT  19                         SFDOOR.MNU  13
  2004.           File transfers  11                SFFILE.BAT  14
  2005.           FORCED=  8                        SFFILE.MNU  14
  2006.           Function keys  19                 SFMAIN.BAT  14
  2007.           GOODBYE=  7                       SFMAIN.MNU  14
  2008.           Help files  17                    SFMESS.BAT  14
  2009.           Home directory  6                 SFMSG.MNU  14
  2010.           Installation Options  5           SHARE  4, 21, 30
  2011.           JETHELP.MAI  6, 17                Shareware  2
  2012.           JETHELP.SEL  6, 17                Software vendors  2
  2013.           JETHELP.USR  6, 17                SPEED=  7
  2014.           JetMail Configuration  6, 21,     SWAP=  10
  2015.               30                            Syntax  4
  2016.           JetMail home directory  18        TMP1.$$$  29
  2017.           JetMail Status Line  19           User's Guide  17
  2018.           JETMAIL.EXE  6                    USERS.JET  21, 29
  2019.           JETMAIL.FIX  30                   WELCOME<x>.BBS  18
  2020.           JETMAIL.ID  6, 17                 WELCOME=  7
  2021.           JETMENU.BBS  6, 17                WildFire  30
  2022.           JETMENU.CLR  6, 17                WORKDIR=  8, 21
  2023.           JETNEWS  17
  2024.           JETSM  22, 24, 29
  2025.           JETTEXT.DAT  6
  2026.           JETXFER.DAT  11, 12
  2027.           Last Message Read pointers 
  2028.               20
  2029.           Local usage  18
  2030.           LOCALDIR=  8, 20
  2031.           LOG=  9, 18
  2032.           MAKECONF.EXE  15, 16
  2033.           MegaMail  2, 7
  2034.           Message numbers  29
  2035.           Multi-node  4, 21
  2036.           Network Sysop  24
  2037.           NEWS=  7, 18
  2038.           NEWUSER  6, 17
  2039.           NOBYE=  9
  2040.           Offline mail reader  2
  2041.           Overwrite  20
  2042.  
  2043.  
  2044.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 31
  2045.  
  2046.  
  2047.